home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / dev / debug / findline.readme < prev    next >
Text File  |  1993-04-11  |  2KB  |  71 lines
  1. Short: findline 37.2 - Find Enforcer/Mungwall hit in program
  2. Uploader: mbs@adastra.cvl.va.us (Michael B. Smith)
  3.  
  4. Yes, this is legal. From the public area on BIX.
  5.  
  6. Easiest to just include the doc file.
  7.  
  8.                             FindLine 37.2
  9.                    Copyright © 1993 David N. Junod
  10.                       Written by David N. Junod
  11.  
  12.  
  13. INTRODUCTION
  14.  
  15. This little utility was inspired by HitMe, written by Doug Walker of
  16. SAS Institute.  It is used to find the source file (and line number)
  17. of an Enforcer hit.
  18.  
  19. One major difference between this utility and HitMe, is that FindLine
  20. looks into the executable for symbol and debugging information to
  21. obtain the source file and line number.  This version does not
  22. require a map file, object files or source files---it only requires
  23. an executable that contains symbols or LINE (and SRC6) debugging
  24. information.
  25.  
  26.  
  27. USAGE
  28.  
  29. FindLine takes the following arguments:
  30.  
  31.   MODNAME/A,OFFSET/A,HUNK
  32.  
  33. Following is a description of the arguments.
  34.  
  35.   MODNAME/A
  36.   Name of the application.  First looks in <modname>.ld.
  37.  
  38.   OFFSET
  39.   The hexidecimal offset of the Enforcer hit.
  40.  
  41.   HUNK
  42.   The hexidecimal hunk number of the Enforcer hit.  Defaults to zero.
  43.  
  44.  
  45. REQUIREMENTS
  46.  
  47. Your C files must be compiled with SAS/C 5.x or beyond, with LINE
  48. debugging turned on.  Best results are obtained with SAS/C 6.x and
  49. beyond.
  50.  
  51. Assembly files must be compiled with CAPE (or HX68) with DEBUG turned
  52. on.
  53.  
  54. This utility should work with any compiler or assembler that produces
  55. standard LINE debugging hunks.
  56.  
  57. When using Enforcer (and MungWall) you should be using SegTracker for
  58. best results.
  59.  
  60.  
  61. CHANGES
  62.  
  63. 37.2 (11-Mar-93)
  64.  
  65. No longer requires a map file.  Uses asyncio to access the executable
  66. (greatly speeds access).
  67.  
  68.  
  69. ~DNJ~
  70.  
  71.